home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 29 / Mac Magazin and MacEasy Magazine CD - Issue 29.iso / Utilities / TurboFind ƒ / Documentation SimpleText next >
Text File  |  1996-12-18  |  9KB  |  198 lines

  1. TurboFind
  2.  
  3.  
  4.  
  5.  
  6. Fast searching of files in a folder hierarchy.
  7.  
  8. Operation
  9.  
  10. Run the program, drag a folder from the Finder to the window, type in the word you want to find and press Return to start searching. Command-Period aborts the search.
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28. The list of files that contain the word you entered will be shown when the search completes. Double-click the filename to view the file. The found word is shown in context in the list.
  29.  
  30. Double-click the line to view the file in a text window. Here you can find the word you searched for, or other words in this window.
  31.  
  32. You can save a document with the find string and a start folder in a document to use again in the future. I recommend saving documents with useful start folders.
  33.  
  34. Details
  35.  
  36. I wrote this little app primarily for speed, so it is unkind to other applications while searching. By default it only searches in files of type 'TEXT' and only in the first 2Mb of the file (although the entire file will be viewed if there is enough memory).
  37.  
  38. TurboFind first looks at the file name to see if that matches what you are looking for, if the search content option is on in the preferences, TurboFind looks in the data of the file for the string you are searching for.
  39.  
  40. The search will cover all files inside the start folder you drag in to window and shown the "in:" field and will recurse down through all subfolders in it.
  41.  
  42. You can also launch TurboFind by dragging a folder or disk to the program icon to set the search place.
  43.  
  44. Once a line in the found list is selected (either by clicking, or with the down/up arrow keys), pressing the Enter key will view the file.
  45.  
  46. You can use menus or key equivalents to: reveal the selected file in the Finder, get Info in the Finder, or “Run” the file in the Finder (equivalent to double-clicking it).
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Preferences
  71.  
  72. If “Search file content” is on, TurboFind looks in the file data.
  73. If “Search all file types” is off, only TEXT files are searched (the default).
  74. If “Case sensitive” is on, only matches with the same capitalisation are found.
  75. Regular expressions are a powerful way to describe text match patterns.
  76. You can choose how many thousand characters of a file (k) to search.
  77. If “Sort the hit list” sorts the list of matching filenames alphabetically.
  78. “Show all matches” will show each line of the file that contains a match.
  79. You can view in TurboFind, with XTND to show styles, if available, or
  80. You can choose an external application to be asked to view the document.
  81. Files can be saved from the text view window and you can choose the creator.
  82.  
  83. Note that if you “feel the need for speed”, search without regular expressions and with show all matches off and the list of matching files will come up most quickly.
  84.  
  85. Licensing
  86.  
  87. TurboFind is © 1996 Peter Marks, if you find that you use it more than 20 times a US$10 shareware fee is required.
  88.  
  89. Here is the pricing shedule:
  90. Each single user license is US$10 per user. (Cheap considering the time it saves you!)
  91. A site license costs US$500, and covers all users for your organisation within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you don’t need to keep track of how many people at your site are using the software.
  92. A World-Wide License costs US$2000 and it covers all locations for your organisation on the planet earth.
  93.  
  94. Paying is easy!
  95.  
  96. Paying for TurboFind is simple. You can register via the web at:
  97.  
  98. <http://kagi.direct.net/cgi-bin/register1.cgi?VZ> 
  99.  
  100. (If you have Internet Config 1.2 or later you can click on the URL in the TurboFind about box). Or...
  101.  
  102. Open the Register program that accompanies TurboFind. Enter your name, your email address, and the number of single user licenses you desire to purchase (or Site or World-Wide licenses). Save or Copy or Pint the data from the Register program and send the data and payment to Kagi. Kagi handles my payment processing.
  103.  
  104. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and attach the file to an email message. There is no need to compress the data, it’s already pretty small. If you have a fax modem, just Print the data to the Kagi fax number.
  105.  
  106. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 10 days and if you provide a correct internet email address you will receive an email acknowledgement.
  107.  
  108. Copyrights
  109.  
  110. Peter Marks accepts no responsibility for any damage done by this software.
  111.  
  112. Regular expression library © 1986 by University of Toronto. As altered by John Gilmore, James A. Woods, and Thomas R. Kimpton,
  113.  
  114. WASTE Text engine © 1993-1995 Marco Piovanelli, used the wrapper class by ©1995 Hiroshi Lockheimer and Timothy Paustian.
  115.  
  116. LBalloonTracker is © 1996 Corporate Software & Technologies Int. Inc. (CS&T)
  117.  
  118. Thanks
  119.  
  120. Pete Gontier for MoreFinderEvents. (A living international treasure).
  121. Jim Luther for MoreFiles. (So great it should be in the toolbox!).
  122. Metrowerks and Greg Dow for CodeWarrior and PowerPlant.
  123. Marco Piovanelli for the WASTE text edit engine.
  124. Hiroshi Lockheimer and Timothy Paustian for the wrapper class for PowerPlant.
  125. Struan Robertson and Allan Bell for feedback and support.
  126. Mark Nagata for professional bug reporting and feature suggestions.
  127. Kagi for having thought things out so well.
  128. Peter N Lewis for the Register application, Internet Config, and feedback.
  129. LBalloonTracker is © 1996 Corporate Software & Technologies Int. Inc. (CS&T).
  130. Markus Gail for improving the icons and letting me ship them.
  131.  
  132. What users have said
  133.  
  134. Mark, a Japanese user…
  135. “It works great, both on my IIci running System J1-7.1 and on my PB5300ce 
  136. running System J1-7.5.5.  The filenames are beautifully displayed with 
  137. Osaka 9pt font.”
  138.  
  139. Gary…
  140. “Wow, it is really great.  You should ask for a penny for each minute it
  141. saves the users.  You would be rich real soon.
  142. Thanks for a really great tool.”
  143.  
  144. Frederico…
  145. "You did it again!
  146. Congratulations and thanks for your useful TurboFind. "
  147.  
  148. Farhad…
  149. "TurboFind is cool. Something to replace XXXXX with. The drag into the window is nice..."
  150.  
  151. Tom…
  152. "Turbofind works well -- good job."
  153.  
  154. Jean…
  155. "1) well done."
  156.  
  157. Collections which have been given permission to include TurboFind: MacAddict, MacWorld (Polish edition), Mac Fan (Japan), 
  158.  
  159. History
  160.  
  161. 2.0  Released as ShareWare.
  162.  
  163. Regular Expression Syntax
  164.  
  165. If the regular expression option is checked in the preferences, then the filename, and then (if search content is on), each line of the content of each file is searched for a match with the regular expression you entered.
  166.  
  167. Regular expression are a rather obscure, but very powerful way of expressing a string of text you wish to find. The notes here are for experienced users, if you haven’t used this stuff before I suggest you look for a tutorial in a unix book on grep.
  168.  
  169. This is reproduced from the class posted by Thomas R. Kimpton to the Metrowerks PowerPlant archive (Thanks Thomas!).
  170.  
  171. A regular expression is zero or more branches, separated by '|'.
  172. It matches anything that matches one of the branches.
  173.  
  174. A branch is zero or more pieces, concatenated.
  175. It matches a match for the first, followed by a match for the second, etc.
  176.  
  177. A piece is an atom possibly followed by '*', '+', or '?'.
  178. An atom followed by '*' matches a sequence of 0 or more matches of the atom.
  179. An atom followed by '+' matches a sequence of 1 or more matches of the atom.
  180. An atom followed by '?' matches a match of the atom, or the null string.
  181.  
  182. An atom is a regular expression in parentheses (matching a match for the
  183. regular expression), a range (see below), '.' (matching any single character), '^' (matching the null string at the beginning of the input string), '$' (matching the null string at the end of the input string), a '\' followed by a single character (matching that character), or a single character with no other significance (matching that character).
  184.  
  185. A range is a sequence of characters enclosed in '[]'.
  186. It normally matches any single character from the sequence.
  187. If the sequence begins with '^', it matches any single character not from the rest of the sequence. If two characters in the sequence are separated by '-', this is shorthand for the full list of ASCII characters between them
  188. (e.g. '[0-9]' matches any decimal digit).
  189.  
  190. To include a literal ']' in the sequence, make it the first character (following a possible '^'). To include a literal '-', make it the first or last character.
  191.  
  192. Notes
  193.  
  194. • If you double-click on a binary file of some kind that can’t be viewed with XTND (or if it’s off) it can take a long time for the view window to open.
  195. • If the use XTND checkbox is dimmed on a PowerPC it might be because you don’t have the “XTND Power Enabler” extension installed.
  196. • Before the actual search begins, TurboFind walks the folder heirarchy counting the files so it can give you a progress bar. This can be time consuming so you can skip this step with one Command-period while the barber pole pattern is showing.
  197.  
  198. [End]